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GENERAL DESCRIPTION 


QWIKLOG is designed to provide a convenient and compact analysis 
of job inforaation contained within an MCP tog files. The log is 
a disk file of system activity maintained by the MCP when the LOG 
eption is set (refer to the SL System Control Instruction). Data 
is presented by QWIKLOG in two distinct formats: a tabular 
suasary of selected information about each jobs and a 
“chronocgraph® which graphicakity indicates schedule and mix 
activity at any point in tise. | 


BELATED DOCUMENTATION 


Nase 4 | Nusber 


B81800/B1700 Softuare Operational Guide 1068731 
B1800/81700 MCP II PoS- 2212 5462 
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OPERATING INSIRUCIIONS 


By defaults QWIKLOG anslyzes the currentiy active tog files 
SYSTEM/LOG. SVYSTEM/LOG aay be “transferred” at any time by the 
operator (refer to the LG and TL system Controt Instructions) or 
automaticatly by the MCP upon reaching maximum capacity. This 
action renames SVSTEM/LOG as LOG/&<integer> and creates a neu 
SYSTEM/LOG file. Such a transferred tog file may te anatyzed by 
file~equating the ftite LOGFILE when executing QWIKLOG> as 
follous: | 


EX QWIKLOGSFILE LOGFILE NAME LOG/#<tinteger> 
where the six digit <integer> identifies the desired log file. — 


{If fite LOGFILE is file-equated to the single rane of LCG» 
QWIKLOG requests the <integer> with an ACCEPT message. Leading 
zeroes need not be provided and» as with all progqras input» the 
input message may be entered in free~forsat. 


OWIKLOG noraally prints both parts of the siiaeyatie described 
above for ali jobs within the log file. If» however» QWIKLOG is 
executed with SW8 = is it requests information to control its 
actions. The three sessages which appear are: 


JOG SUMMARY? CY/N). 


Enter Ys YES» Ne or NO. 


GRAPH? (Y/N) 


Enter Ys YES» Ne» or NO- 


JOB NUMBER RANGE? “ALL" OR <FRON> (<TO0>] 


This aiflows selection of a specific range of jobs for anaiysis. 
ALL specifies that all jobs within the given log file are toa be 
proecessed €as is done in the defaudit case); otherutse the tirst 
integer (<FROM>) is used as the Lower beund for the job nusber 
range to be analyzed. Analysis continues for the remainder of 


the tog files unfess 2a second integer (€<¥0>) is provided to 


indicate an upper bound. CQWIKLOG requires in this case that <1TQO> 
not be tess than <fFROM>. | 


If analysis is done upon SYSTEM/LOG= QWIKLOG stops after the job 


imaediately preceding itselif> unless further restricted in range 
as previously described. 


Two other program switches affect the operation of QWIKLOG. 
Suitch 0 is used to speci fy the width of the tine printer being 
useds the defauit of zero (C0) iapties 132 print positions and a 
one aD indicates 120 print positions. Users with 120 ccluan 
printers can eeegeonnne’ set this switch with. the foilowing MCP 
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If SH9 = Il» job sumaary inforgation is not printec across page 


per forations. 
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‘QUIEUT DESCRIPTION 

The fotlouing inforsation is provided in the job suseaeary portion 

of the QNIKLOG output. Fields inappropriate for a particutar job 

are Left blank (for exaaples an RS“ED job has no 8C0J or EQJ date 

and tine). | | 

1. Job Accounting Number. This is a sequential value associated 
with each job which untike the job numbers» does not wrap 
around from 9999 back to cnes and hence provides a unique 
identification number for the job. An asterisk preceding the 

Job Accounting Number indicates that the job was part cf a 

job stream (refer tc the THEN» AFTER» and AFTER NUMBER 
control instruction attributes). 7 

2e Program nane. 


3. Compiter name if the execute type is a compilation. For a 
Clear/Startes this fielc is used to show the MCF versione 


4. Job nuaber. 

S. Charge nuasbers if non-zero. 

6. Execute type. Iteas that may appear are EXECUTE COMPILE & 
GO» COMPILE & SAVE» COMPILE TO LIBRARY» GO PARY CF COMPILE & 
GO» and GO PART OF COMPILE & SAVE. | 

%e Schedules processors and memory priorities. 

8. Faatiy nage of the interpreter (e.g-» COBOL). 

9e Scheduiting date and tise. 

10. 805 date and tine. 

Lie €0/5 date and time. 

2.2 Elapsed execution tise. 

136 Processor time consuned. 

14. Job termination type. Items that may appear are NORMAL» 

| CS°ED Cincludes OP-ED)» SYNTAX ERRORS» $ABORTED (by a 
Clear/Start)»s RS~“E0s and RUNNING. The fatter fndicates that. 
the job was stilad tin the wix when aAQWIKLOG was executed or 
when the log was transferred. 

i5.j Static mesory assignec Cin bitsde 


16. Oynamic memory assigned Cin bits). 


17. Total non-code memory assigned (Cin bits)» defined as 


+a ARAL EOE atta 
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<static mesory> #¢ <dynanic serory> ¢ <run structure nuctleus>. 
Note that this figure coes not include structures such as 
file buffers. Users interested in a sore coaplete analysis 
of sesory requirements for a given prograsg shouic use the 
CODE/ANALYZER utility. In the entry for a Clear/Starts this 
field contains the main mesory size of the syster in K bytes. 
CiK = 2e«10 = 1024 bytes = 8192 bits). a 


18. The number of files declared within the progras. 


19. ‘The number of code segment overlays (prograss Interpreter 


ano MICRO.MCP) caused by execution of the progras. 
20. The number of data overlays perforned during executions 
21. Segaents of VIRTUAL.DISK Cdisk for data aver tays) assignede 
The following anemonics are used within the chronograph: 


Clear/Start 

Prograag Scheduled 
Program Execution 
Coapiler Execution 
Prograse Running 
Abnormal Tersiration 


37 VOMwW & 


The *R* character indicates that a progras was stitt running at 
the tise of analysis or when the tog was transferred. Thus no 


anemonic. 


E0J tise is avaitabie to properly graph with the “C* or “E* 


The "X* character replaces the "ce or “€" anemonic for the tast 
winute of a job that was OS“ED of was aborted due to a 
Clear /Start to spotlight the abnormat teraination. 
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ERROR MESSAGES 


INCOMPATIBLE SYSTEM SOFTWARE ~- MUST BE <level> MCP..-E0J 


The format of toq records is subject to change betueen 
softuare releasesa In order that valid results be insured» 
QWIKLOG ascertains that it is being run with the proper MCP 
and aborts with this message should an tncoagpatibility be 
detected. : 7 | 


CTRY AGAIN] ENTER LOG NUMBER 


If LOGFILE is file-equated to the single name cf LOG» QWIKLOG 
requests the tog identification integer with this message. 


<filenane> NOT ON OLSKeesEOJ 


The logfile on which the user requested analysis was not in 
the disk directory. 


CTRY AGAIN... 1 JOB SUMMARY 2 CY/N) 
GRAPH 


H¥ith Switch 8 set to one (SW8=1)> QWIKLOG recuests specific 
instructions on what it is to do. The user can request 


either or both of the two outputs presented by CGWIKLOG. The 


preface “TRY AGAIN..." is esitted if the user has supplied 
other than *Y"s “YES"» “N"» of “NO" to these tuo requests. 


LIRY AGAINece] JOB NUMBER RANGE: “ALL OR <FROM>L<TO>) 


The third quantity cf information requested if Switch 8 is 
set to one is the job number range to be processed. 


NULL INPUT INVALID 
The user entered an eapty input tine in an ACCEPT message. 


STARTING JOB NUMBER Taeneegere™ ‘ISn*T NUMERIC 
STOPPING | 


A nen job number was provided in response to CTRY 
AGAIN.<e.}] JOB NUMBER RANGES message above. 


INVALID INPUT: "<token>* 

QWIKLOG decoded operator papue that was contextuatly,. invatid. 
STOP JOB #@ CHANGED CFROM <integer>! TO <integer> | 

If analysis is atteapted on SYSTEM/LOGe QUIKLGG insures that 


the job number range tersinates at the joeb immediately 
preceding itself» unless further ligited by a response to 
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ii 


12. 


gessage (5) abcve. This message inforas the user that the 


job nusber range has been atitered. 


STOPPING JOB NUMBER (<integer>) > STARTING JOB NUMBER 
C<integer> ewe EQS , | 


QWIKLOG terminates if the job nuaber range provided in 


response to message (5) is non~ascendingly ordered. 


HEYeoeT NEED SONE WORK..-E05 


This sessage ts QWIKiCG®S response if the user specifies 
through his response to sessage (4) that neither ai job 
suagary nor a graph are to be produced. 


UNEXPECTED EOF ON LOG“PROBABLE HARDWARE ERRORTEXECUTION 
CONTINUE 


QWIKLOG hit EOF on the log file it was processing at a point 
that was unexpecteds being in the siddle of the series of 
records normatty associated with each job. Processing 
continues on those job records aiready found in the tog file. 
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